home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 2: Applications / Linux Cubed Series 2 - Applications.iso / tex / tetex / distrib / install.src < prev    next >
Text File  |  1996-11-16  |  6KB  |  166 lines
  1. =============================================================================
  2.  
  3.     teTeX-0.3.4 installation instructions (compiling the sources)
  4.  
  5. =============================================================================
  6.  
  7.   1) prerequisites: disk space, gcc, GNU make, flex
  8.   2) getting the files
  9.   3) install the inputs-tree
  10.   4) unpack the sources and apply patches (if there are any):
  11.   5) adjust the Makefile
  12.   6) run make
  13.   7) final configuration steps
  14.   A) appendix: notes on some platforms
  15.  
  16. ============================================================================
  17.   1) prerequisites: disk space, gcc, GNU make, flex
  18. ============================================================================
  19.  
  20. To compile teTeX, you need gcc, flex and a recent version of GNU make.
  21. gcc-2.5.8, flex-2.4.7 and GNU make-3.72.1 or newer should be ok.
  22.  
  23. The gzipped source tree is about 3.8MB, after untarring about 14.8MB,
  24. after "make world" completes about 30MB.
  25.  
  26. =============================================================================
  27.   2) getting the files
  28. ============================================================================
  29.  
  30. What you need:
  31.     sources/teTeX-src-0.3.4.tar.gz  # the sources
  32.     sources/teTeX-src-0.3.4-patch-*.gz    # all patches (if available)
  33.     sources/teTeX-lib-0.3.4.tar.gz  # the lib-tree with the fonts, macros, ...
  34.  
  35. Instead of the complete lib-tree, you can get the smaller files with
  36. fonts, documentation, ... from the other subdirectories. See INSTALL.bin
  37. for notes on installing these files. You do not need to install binaries
  38. when installing via INSTALL.bin.
  39.  
  40. ============================================================================
  41.   3) install the inputs-tree
  42. ============================================================================
  43.  
  44. Unpack teTeX-lib-0.3.4.tar.gz at its "final" destination, e.g.
  45.  
  46.     cd /usr/local
  47.     gzip -dc /usr/local/src/teTeX-lib-0.3.4.tar.gz | tar xpvf -
  48.  
  49. You may choose a different directory instead of /usr/local and you may
  50. rename the teTeX directory. Just make sure to have the TETEXDIR
  51. variable in the top-level Makefile right before starting make.
  52.  
  53. Note: if you omit the "p" option of tar, you may have trouble with
  54.       permissions later.
  55.  
  56. If you install the smaller packages from the base, fonts, doc and goodies
  57. directories, use install.sh (see INSTALL.bin for details).
  58.  
  59. ============================================================================
  60.   4) unpack the sources and apply patches (if there are any):
  61. ============================================================================
  62.  
  63. Unpack the sources, e.g.:
  64.     cd /usr/local/src
  65.     gzip -dc teTeX-src-0.3.4.tar.gz | tar xpvf -
  66. Apply patches:
  67.     gzip -dc teTeX-src-0.3.4-patch-* | patch -p0 -s
  68.  
  69. NOTE: if you unpack as root on a SYSV system, you may need to chown -R
  70.   afterwards, to fix wrong ownerships.
  71.  
  72. ============================================================================
  73.   5) adjust the Makefile
  74. ============================================================================
  75.  
  76. Have a look at the Makefile and adjust what needs to be adjusted. E.g.:
  77.  
  78.     cd teTeX-src-0.3.4
  79.     vi Makefile
  80.  
  81. ============================================================================
  82.   6) run make
  83. ============================================================================
  84.  
  85. Type "make world" and relax :-)
  86.  
  87. This is equivalent to
  88.   make config clean texhash all install ini
  89.  
  90. If you need special previleges for 'make install' and 'make ini', you can
  91. run two make in two separate runs:
  92.   make config clean texhash all
  93.   su
  94.   make install ini
  95.  
  96. If you install for a second, third, ... platform, you can omit the 'texhash'
  97. and 'ini' targets and simply run:
  98.   make config clean all
  99.   make install
  100.  
  101. Please note that calling make with an absolute path breaks the configure
  102. scripts.
  103.  
  104. The following example _does_not_work_:
  105.     /usr/local/bin/make world
  106.     ...
  107.     checking whether /usr/local/bin/make sets $MAKE... ./configure:
  108.     ${ac_cv_prog_make_/usr/bin/make_set+set}: bad substitution
  109.     ...
  110.  
  111. ============================================================================
  112.   7) final configuration steps
  113. ============================================================================
  114.  
  115. Overview:
  116.   - set up PATH
  117.   - check environment
  118.   - configure teTeX using texconfig
  119.  
  120. Set up PATH:
  121. ===========
  122. Set up your PATH to include the directory containing the just installed
  123. binaries (e.g. /usr/local/teTeX/bin/sparc-sunos4.1.3); similarly, MANPATH
  124. and INFOPATH to include the relevant newly installed subdirectories.
  125.  
  126. Check environment
  127. =================
  128. Note, that the run-time search paths for all programs that use
  129. the Kpathsea library can be configured by changing the paths in
  130. TETEXDIR/texmf.cnf and changes to these paths does not require to
  131. recompile any of the programs. Therefore, you hardly need to set extra
  132. environment variables. If you define some environment variables, they
  133. overrule the search paths in texmf.cnf unless they have an empty path
  134. component (i.e. a colon at the beginning or end or a doubled colon in
  135. the middle).
  136.  
  137. The variables to check are:
  138.   BIBINPUTS BSTINPUTS DVIPSHEADERS GFFONTS GLYPHFONTS MFBASES MFINPUTS
  139.   MFPOOL PKFONTS TEXCONFIG TEXFONTS TEXFORMATS TEXINPUTS TEXMFCNF TEXPICTS
  140.   TEXPKS TEXPOOL TFMFONTS VFFONTS DVIPSFONTS XDVIVFS XDVIFONTS DVILJFONTS
  141.  
  142. A simple way to check them is to run
  143.   texconfig confall
  144. once you have set up your PATH. Be careful if some variables are non-empty
  145. and have a look at the locations of the binaries. Not all binaries are
  146. checked, only some.
  147.  
  148. Configure teTeX using texconfig
  149. ===============================
  150. Texconfig allows you to set the defaults for hyphenation, paper size,
  151. print command, metafont mode, etc. You should run theis command
  152. interactively and see what options it offers.
  153.  
  154. =============================================================================
  155.  A) appendix: notes on some platforms
  156. =============================================================================
  157.  
  158. SGI-IRIX-6.0.1: (reported by bottoms@radar.nrl.navy.mil (Maitland Bottoms))
  159.     successfully compiled using:
  160.         CC=cc
  161.         CFLAGS=-O2 -s -32
  162.         LDFLAGS=-s -32
  163.  
  164. ULTRIX:  use /bin/sh5 in shell-scripts.
  165. AIX 4.X: use /bin/bsh in shell-scripts.
  166.